PI91747: CQ 9.0.X CQTOOL FAILS TO RUN.

Rational ClearQuest Fix Pack 3 (9.0.1.3) for 9.0.1
Rational ClearQuest Fix Pack 4 (9.0.1.4) for 9.0.1
Rational ClearQuest Fix Pack 5 (9.0.1.5) for 9.0.1
Rational ClearQuest Fix Pack 6 (9.0.1.6) for 9.0.1
Rational ClearQuest Fix Pack 7 (9.0.1.7) for 9.0.1
Rational ClearQuest Fix Pack 8 (9.0.1.8) for 9.0.1
Rational ClearQuest Fix Pack 9 (9.0.1.9) for 9.0.1

APAR status

• Closed as program error.

Error description

• When starting CQ 9.0.x cqtool it will not start but throw
  following error:
  
  C:\Users\Administrator>cqtool
  Can't load JNI module. Did you build it at install time?
  Error: Can't load 'C:/Program Files
  (x86)/IBM/RationalSDLC/common/lib/perl5/site
  _perl/5.16.1/MSWin32-x86-thread-multi/auto/Inline/Java/JNI/JNI.d
  ll' for module I
  nline::Java::JNI: load_file:The specified module could not be
  found at C:/Progra
  m Files
  (x86)/IBM/RationalSDLC/common/lib/perl5/5.16.1/MSWin32-x86-threa
  d-multi/
  DynaLoader.pm line 190.
   at C:/Program Files
  (x86)/IBM/RationalSDLC/common/lib/perl5/site_perl/5.16.1/MS
  Win32-x86-thread-multi/Inline/Java.pm line 193.
   at C:/Program Files
  (x86)/IBM/RationalSDLC/common/lib/perl5/site_perl/5.16.1/MS
  Win32-x86-thread-multi/Inline/Java.pm line 193.
  Compilation failed in require at C:/Program Files
  (x86)/IBM/RationalSDLC/common/
  lib/perl5/site_perl/5.16.1/MSWin32-x86-thread-multi/Inline/Java.
  pm line 193.
  BEGIN failed--compilation aborted at C:/Program Files
  (x86)/IBM/RationalSDLC/com
  mon/lib/perl5/site_perl/5.16.1/cqcli/Util.pm line 105.
  Compilation failed in require at C:\Program Files
  (x86)\IBM\RationalSDLC\Clearqu
  est\cqcli\bin\cqtool.pl line 43.
  BEGIN failed--compilation aborted at C:\Program Files
  (x86)\IBM\RationalSDLC\Cle
  arquest\cqcli\bin\cqtool.pl line 43.
  
  This is caused by incorrect paths in the CQCLI_PATH environment
  variable. Specifically the path to the CQ provided JRE.
  
  The out-of-the-box value is:
  CQCLI_PATH=C:\Program Files
  (x86)\IBM\RationalSDLC\ClearQuest;C:\Program Files
  (x86)\IBM\RationalSDLC\Common;C:\Program Files
  (x86)\IBM\RationalSDLC\Common\Java5.0\jre\bin;C:\Program Files
  (x86)\IBM\RationalSDLC\Common\Java5.0\jre\bin\classic;C:\Program
  Files (x86)\IBM\RationalSDLC\Clearquest\cqcli\bin;C:\Program
  Files
  (x86)\IBM\RationalSDLC\common;C:\Windows\system32;C:\Windows;C:\
  Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0
  \;C:\Program Files (x86)\IBM\gsk8\lib;C:\Program Files
  (x86)\IBM\gsk8\bin
  
  This is correct for CQ 8.0.1.x, but not for 9.0.1.x, where the
  (newer) JRE is located in ...\Common\JAVA\...
  Changing the two incorrect paths in the environment variable
  allow cqtool to run with CLearQuest 9.0.x.
  
  Corrected variable:
  CQCLI_PATH=C:\Program Files
  (x86)\IBM\RationalSDLC\ClearQuest;C:\Program Files
  (x86)\IBM\RationalSDLC\Common;C:\Program Files
  (x86)\IBM\RationalSDLC\common\JAVA\jre\bin;C:\Program Files
  (x86)\IBM\RationalSDLC\common\JAVA\jre\bin\classic;C:\Program
  Files (x86)\IBM\RationalSDLC\Clearquest\cqcli\bin;C:\Program
  Files
  (x86)\IBM\RationalSDLC\common;C:\Windows\system32;C:\Windows;C:\
  Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0
  \;C:\Program Files (x86)\IBM\gsk8\lib;C:\Program Files
  (x86)\IBM\gsk8\bin
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ClearQuest                                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The ClearQuest cqtool fails to start because the path to the *
  * JRE is wrong in the CQCLI_PATH environment variable.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• A fix is available in ClearQuest 9.0.1.3
  The path to the JRE has been corrected in the CQCLI_PATH
  environment variable.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  CQ&CQ MSITE WIN

• Fixed component ID

  5724G3800

Applicable component levels

• R901 PSY

     UP